Motionsound Notch Encoder
=========================

Converts videos (MP4, MOV, ProRes, H.264/H.265, MKV, AVI...) and image
sequences (PNG, TIFF, EXR, JPG...) to NotchLC .mov files, with alpha.
Compression uses Notch's own NotchLC codec.


BEFORE FIRST USE (one-time setup)
---------------------------------
1. Windows 10 or 11, 64-bit, with a DirectX 11 graphics card.

2. Install Notch's free "NotchLC for AVI & Legacy QuickTime" plugin:
   https://notchlc.notch.one/  ("Legacy QuickTime and AVI", not the Adobe one)
   No Notch licence is needed.

3. ffmpeg. If it isn't installed, the app shows an "Install ffmpeg" button,
   which installs it with Windows' winget. You can also run this yourself in a terminal:
       winget install Gyan.FFmpeg

When both are found, the top-right of the window shows:
   Ready:  NotchLC codec ✓   ffmpeg ✓


HOW TO USE
----------
- Unzip the folder anywhere and double-click "Motionsound Notch Encoder.exe".
  Keep the "_internal" folder next to the exe.
- Add files by dragging them onto the window, or use Add files / Add folder /
  Add image sequence (pick the FIRST image of the sequence).
  You can also drop files onto the .exe icon itself.
  Single images (JPG, PNG, TIFF...) become still clips. Numbered images with
  neighbours (shot_0001.png, shot_0002.png...) become one image sequence.
- Choose your settings and press Encode. Files are saved as  name.mov  (plus the
  name suffix, if you set one) next to the originals, or in the folder you choose.
  An original is never overwritten: if the output would replace its source
  (e.g. clip.mov next to clip.mov), it is saved as clip_NotchLC.mov instead.

Settings:
  Resolution     Same as source, a preset, or Custom (leave width or height blank to keep the aspect ratio)
  Frame rate     Same as source, or pick or type one (e.g. 23.976, 25, 59.94)
  Alpha          Auto keeps transparency when the source has it (ProRes 4444, PNG,
                 QuickTime Animation...). "Always" adds an opaque alpha channel. "Drop" removes it.
  Audio          Include the first audio track as uncompressed PCM
  Image fps      Frame rate for image sequences and still images
  Start          Optional: skip this many seconds into the source
  Length         Optional seconds + frames, e.g. 0 sec + 5 frames, or 10 sec + 10 frames.
                 Exact frame count at the output frame rate (no 10.333 maths).
                 Blank = the whole clip. Still images default to 1 frame.
  Quality        Fixed. Notch's AVI codec has a single (high) quality level.

Notes:
  - Untagged H.264 files are treated as Rec.709 when 720p or larger, and Rec.601 below that.
  - Alpha is straight (not premultiplied), the same as Notch's Adobe plugin.
  - Tested in Disguise: plays back correctly, including alpha.
  - Settings are remembered between sessions.


COMMAND LINE (optional)
-----------------------
    "Motionsound Notch Encoder.exe" --cli <files or folders> [options]
    "Motionsound Notch Encoder.exe" --cli -h          (lists all options)
Example:
    "Motionsound Notch Encoder.exe" --cli "D:\Renders" -o "D:\NotchLC" --size 3840x2160 --fps 60
    "Motionsound Notch Encoder.exe" --cli logo.png --frames 5          (5-frame clip from a still)
    "Motionsound Notch Encoder.exe" --cli clip.mp4 --duration 10 --frames 10   (exactly 10 s 10 f)


THIRD-PARTY SOFTWARE
--------------------
Built with Python (PSF licence), Tcl/Tk (BSD-style), NumPy (BSD) and python-lz4 (BSD),
packaged with PyInstaller. ffmpeg and the NotchLC codec are installed separately and are
not included. NotchLC is a codec by 10bit FX / Notch.
